Skip to content

feat: add multi-transport variants for MCP server definitions - #21

Merged
its-mash merged 5 commits into
mainfrom
feat/multi-transport-variants
Feb 19, 2026
Merged

feat: add multi-transport variants for MCP server definitions#21
its-mash merged 5 commits into
mainfrom
feat/multi-transport-variants

Conversation

@its-mash

Copy link
Copy Markdown
Member

Summary

  • Split 9 single-transport server definitions into 21 transport-specific variants so users can choose how to connect (Remote HTTP, Docker, npx, Enterprise/Self-Hosted)
  • Total server definitions: 28 (up from 16), all passing schema validation
  • Each variant has a unique ID, descriptive name, and properly defined inputs with placeholders, obtain instructions, and secret flags

New variants by server

Server Variants Transport types
GitHub Remote HTTP (OAuth), Docker (PAT), Enterprise (PAT + Host) http, stdio/docker, stdio/docker
Grafana Self-Hosted (Docker), Cloud (Docker) stdio/docker, stdio/docker
Notion Remote HTTP (OAuth), npx (token), Docker (token) http, stdio/npx, stdio/docker
Sentry Remote HTTP (OAuth), npx (token), Self-Hosted (token + host) http, stdio/npx, stdio/npx
Supabase Remote HTTP (OAuth), npx (token) http, stdio/npx
Playwright npx (headed), Docker (headless Chromium) stdio/npx, stdio/docker
Slack npx (bot token), Docker (bot token) stdio/npx, stdio/docker
Brave Search npx (API key), Docker (API key) stdio/npx, stdio/docker
Exa Search npx (API key), Remote HTTP (API key) stdio/npx, http

Unchanged servers (single variant only)

Atlassian, Cloudflare Docs, Cloudflare Bindings, Figma, Filesystem, Puppeteer, SQLite

Breaking changes

  • All 9 renamed servers have new IDs (e.g., com.github-mcpcom.github-mcp-docker)
  • File names updated to match IDs

Test plan

  • node scripts/validate.js --all passes for all 28 definitions
  • All ${input:XXX} references have matching input definitions
  • All IDs are unique and match filenames
  • All URLs (links, obtain, transport) are valid
  • Secret inputs properly marked with secret: true

Split single server definitions into multiple variants based on
transport/connection method and audience. Users can now choose between
Remote HTTP (OAuth), Docker, npx, and self-hosted/enterprise options
when installing a server.

New variants added:
- GitHub: Remote HTTP, Docker, Enterprise (GHES/GHEC)
- Grafana: Self-Hosted, Cloud
- Notion: Remote HTTP, npx, Docker
- Sentry: Remote HTTP, npx, Self-Hosted
- Supabase: Remote HTTP, npx
- Playwright: npx, Docker
- Slack: npx, Docker
- Brave Search: npx, Docker
- Exa Search: npx, Remote HTTP

Total: 28 definitions (up from 16). All pass schema validation.
Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
Allow users to optionally provide a Personal Access Token instead of
using the default OAuth flow. Auth type changed to optional_api_key.

Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
- com.github-mcp-http: pure OAuth, zero config
- com.github-mcp-http-pat: PAT-based auth with required token input

Cleaner separation so users pick the auth method they want.

Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
… variant

- Add optional `headers` field to HTTP transport schema for sending
  custom headers (supports ${input:ID} interpolation)
- GitHub PAT variant now sends `Authorization: Bearer ${input:GITHUB_TOKEN}`

Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
- Merge GitHub Docker + Enterprise into single definition with optional
  GITHUB_HOST input (empty defaults to github.com internally)
- Merge Grafana Self-Hosted + Cloud into single Docker definition with
  all inputs (URL required, username/password optional)
- Remove GitHub Remote OAuth (com.github-mcp-http) - no DCR support
- Fix GITHUB_HOST type from url to text (expects hostname, not URL)
- Keep Sentry npx + Self-Hosted separate (MCP_DISABLE_SKILLS=seer)

Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
@its-mash
its-mash merged commit 0217546 into main Feb 19, 2026
1 check passed
@its-mash
its-mash deleted the feat/multi-transport-variants branch February 19, 2026 10:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant